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The NOVA symbolic debugger, DEBUG 111, is a program that interfaces with user 
routines as an aid in debugging* DEBUG III provides for up to 8 active breakpoints 
within the user's routines. The accumulators. Carry, and memory can be examined 
and modified from the teletype after a breaJq>oint has occurred. The machine state 
can be monitored during execution of a routine using simple commands to the debug- 
ger from the teletype. The Debugger interfaces with any NOVA routine, including 
those using the NOVA interrupt structure. The Debugger can also be used to punch 
ranges of memory in binary format acceptable as input to the Binary Loader, 



The following versions of DEBUG III are available; 

1. Relocatable - No Disk Operating System 

DEBUG III uses a pointer to the user symbol table, placed by the loader in location 44. 

Disks are optional. Tbe version can be used with any NOVA or SUPERNOVA config- 
uration but 8K is recommended to insure that the debugger, user program, and 
symbol table can aH be loaded. This version is described in full in the manual. 

2. Relocatable - Disk Operating System 

DEBUG III uses a symbol pointer contained in the user status area. Certain features 
of version 1 are unnecessary. These include all disk commands* all punch commands, 
and the register commands $T and $L Any NOVA or SUPERNOVA configuration having 
the Disk Operating System car be used. 

3. Absolute - No Disk Operating System. 

DEBUG III can be used without symbolic debugging features with any NOVA or 
SUPERNOVA, Use of disks is optional. Absolute addresses replace symbolic input 
and output. 

Instructions for loading the various DEBUG III versions are given in the APPENDIX 
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Offi RATION 

DEBUG 1 1 1 is loaded into memory with a user program or programs, DEBUG ill 
can be loaded before or after the user program. In the relocatable, nan -DOS 
DEBUG II! described in this manual, DEBUG III starts at location 400 if leaded 
before the user program and can be restarted from that point if control is lost 
during the testing process. Loading instructions for this and other versions of 
DEBUG 111 are given in the APPENDIX, 

To use symbolic addressing when debusing, the user program must contain at 
least one user symbol. User symbols are made known to the debugger by issuing 
the command: 

name% 

where: name is the title given the user program via the . T1TL pseudo-op. 

The command can be issued as soon as the debugger and user program are loaded. 

COMMAND FORMAT 

Commands to DEBUG III have one of the following formats; 



$ c 

arg$ c 

where; command c is a single teletype code 
argument arg may be null, a digit, an address, or 

an expression. 

$ is the mode change character, (Press ESC Key or 

Shift 4 on the teletypewriter for this symbol, ) 

Expressions have the for::-; 

where: each x is some symbol* octal number, or decimal number 
+ and - are addition and subtraction. 

Commands begin at the first character position on the teletype line. 
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SYMBOLS AND CONVENTIONS 



SYMBOL 



(Space) 



# 



§ 



MEANING 

addition 

subtraction 

separates instruction fields 

separates instruction fields 

adds 10 (used with a source- 
destination accumulator 
instruction) 

adds 100000 to data and 
adds 2000 to an instruction 

delimits beginning and end 
of a one character string; 
delimits beginning and, 
optionally, the end of a 
two -character string, 

can be used as first charac - 
ter of a user symbol 

terminates a decimal number 

can be used to represent 
current location. In the ex- 
ample f AA is the current 

location symbol and the 
commands AA/ and . / produce 
identical results, The JMP 
instruction causes a transfer 
to the current location plus 2 



EXA MPLE 

NEXT+SUMfl 

SUM2-SUM1 

LDA 

LDA 0,0,0. 

ADCZ# 1 SZC= 106032 

command response 

@r 100000 

LDA @0 0= .022000, 

v— / v -~ v — 

command response 

"a" 
"ab" 

"ab 

.PR2 
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AA/ NEG 

./ NEG 

JMP .+2 



SYMBOLS AND CONVENTIONS (cont'd. ) 
SYMBOL MEANING 



d 



JT 



f 



conventional represen&ttan for 
pressing carriage RETURN key* 
This closes a memory register 
after examination and possible 

modification 

conventional representation 
for pressing LINE FEED key 
This closes a memory register 
after examination and possible 
modification and opens the next 
consecutive register 

conventional representation for 
the ESC key (although the $ 
symbol may be typed, ) $ signals 
a mode change in a command. 

symbol used to close a memory 
register after examination and 
possible modification and open 
the previous register 



EXAMPLE 



AA/ NEC NEC 1 



AA/ NEC 1 1 *. 
AA+l/LDA .FD21 -f 
AA+-2/STA 1 .FD10 



$L 



AA+2/STA 1 FD10 4 
AA+1/LDA0 .FD21 



USER TYPING ERRORS 

Hie user can kill an incorrect command or typing error by pressing the RUBOUT key. 
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COMMAND SUMMARY 

The Symbolic Debugger provides extensive facilities for examining and modifying 

program status. The summary below indicates available commands. 



COMMAND 



PAGE WHERE 
DESCRIBED 



$= 
$: 
$; 

adr! 



name % 

$K 

n$K 

L$K 



$S 

adr$S 

adr<$S 

e.o-:-j.-tidr2$S 

$F 
n$F 
$E 
adr$E 

adrl<adr2$P 



Print last typed quantity in numeric form. 
Print last typed quantity to symbols. 
Print last typed quantity in instruction form. 
Print last typed quantity in half-word form. 
Print last typed quantity in ASCI! form. 

Print subsequent quantities in numeric form, 
Print subsequent quantities in user symbol form. 
Print subsequent quantities in instruction form. 
Print subsequent quantities in half-word form. 
Print subsequent quantities in ASCII form. 

Open register adr and type contents. 

Open register adr. 

Close open register. 

Close open register and open next. 

Close open register and open previous. 

Enable symbols in program name. 

Kill all user symbols. 

Kill local user symbols, n is single digit. 

Kill user symbol sym. 



18 
18 
18 
18 
18 

18 
18 
18 
18 
18 

7 
7 
7 
7 
7 

2, 17 

17 
17 
17 



Search all memory 10 

Search memory from location to location adr, 10 

Search memory from location adr to 077777 inclusive, 10 

Search memory from location adrl to adr 2 inclusive. 10 

Punch 10 decimal inches blank ape. 9 

Punch n (octal or decimal) inches blank tape. 9 

Punch end block on tape. 9 

Punch end block with transfer point adr . 9 

Punch binary tape from location adrl to adr2 inclusive. 9 
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COMMAND SUMMARY (cont'd, ) 



PAGE WHERE 
DESCRIBED 



$1 

n$A 
n$Q 



Open TT1 done register. 

Open Carry and TTO done register, 
Open interrupt register. 
Open accumulator register n. (n = 0-3), 
Open break proceed counter n. (n = 0-7), 



15 
15 
15 
14 
12 



$B 

adr$B 

$D 

n$D 

$P 

n$P 



Print locations of aE user program breakpoints* 

Insert breakpoint at location adr. 

Delete all breakpoints , 

Delete breakpoint n. (n=0-7). 

Proceed from current breakpoint with break 

proceed counter set at +L 

Proceed from current breakpoint with break 

proceed counter set at n 



11 
11 
11 
11 

12 

12 



adr$0 

n) 

n( 



Activate disk block with address adr. 

Open disk register n. of currently active disk block. 

Open and print disk register n of currently active disk 

block. 



$A 



Print all accumulator register contents. 



14 



$M 

$W 
$L 
$N 
$H 



Open mask register. 

Open word register. 
Open location register. 
Open numbers register. 
Open high/low punch register. 



14 
14 
14 
14 

9 



$R 
s ym ':)R 

$G 

sym$ G 



Restart program at address in location register. 

Restart program at address sym. 
Restart program at address in location 
register; set C(AC3) to address of Debugger. 
Restart program at address sym; 
set C(AC3) to address of Debugger. 



16 
16 
16 
16 

16 
16 
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OPENING, MODIFYING, AND CLOSING MEMORY REGISTERS 



FORMAT 

adr! 
adr/ 

<J 

NOTES: 



MEANING 

Open register adr . 

Open register adr and print contents. 

Close most recently opened register, 

Close most recently opened register and open the succeeding register. 

Close most recently opened register and open the previous register. 

When a register is opened and a command is given that does not reference 
the register, the register is automatically closed. If $ is typed with a 
register open, the error message ? will be printed, / or I remain in 
effect until changed when opening and closing registers repetitively 
using and 



EXAMPLES; 



ABC! 
ABC/ADD 1 



—Open register ABC, 

"-Register ABC is opened and contents printed. 



AA/ADD SZC SUB 0» 0. 

Register AA is opened, modified and closed, 

AA/ADD SZC SUB , 
ADD+1 LDA 3-13 ^J 

Register AA is opened, modified, and closed. The next location is opened and its 
contents printed (/ remains in effect during chained openings unless altered. ) 

AA/ADD SZC SUB 0, Of 
A STA TR 

Register AA is opened, modified and closed. Hie previous location, A, is opened and 

its contents printed. 

AA/ADD S ZC ^J —Series of openings and closings of sequential registers. 
AA+1 LDA 3-13 + 
AA+2 JMP BB 4 
AA+1 LDA 3-13 J 

AA/JMP BB/ADD 



AA/JMP BB = 000423 
AA/f MP BR» 003000 



The second / closes register AA unmodified and opens a 
register via the 15 -bit C(AA). 

—Register AA is still open. 

—Register is closed by .= The value of address j(AA) is 3000. 
-7- 



OPENING, MODIFYING AND CLOSING DISK REGISTERS 

Where a disk is used, locations in a disk Mock can be examined and modified in a manner 

similar to memory locations, A disk may have up to 2GG0g blocks (0 to 1777g), 

A block contains 400g locations. Activating a given block deactivates a previously active 

Mock, 



FOR.VL-iT 
sy m $Q 

adr { 

adr ) 

J 

! 

NOTES: 



EXAMPLES 



i$o 



MEANING 

Activate a disk block with name syn^ where sym_is numeric (0 to 1777 8 ) 
or symbolic, 

Open active disk register adr and print contents, adr may be symbolic, 
-:c:v (?-3"7}-. ^r cVc: : .^?.R 

Open active disk register adr. 

Close active disk block register, 

Close active disk block register and open succeeding register. 

Close active disk block register and open previous register. 

The 4) : ^land 4 commands are used in the same way as when 

closing memory registers. 

These commands are not needed when using DEBUG III with the 
Disk Operating System. 



f 



-activate disk block 1 



RAD(LDA USE J —open and print register RAD 
RAD+1 ADD ofosZRt 

r;,d lda use 



o$o 



■•-activate disk block 0; 

deactivate disk block 1 
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PUNCH COMMANDS 



FORMAT MEANING 

$H Open and print contents of high/low register. Zeroes in the register mean 

the teletype punch; otherwise, the high-speed punch is meant. 

$F Punch 10 decimal Inches blank tape, 

n$F Punch n (octal or decimal) Inches blank tape. 

$E Punch an end Mock on the tape and halt. (Used only with teletype punch. ) 

adr$E Punch an end Mock on tape with transfer to location adr when the tape is read 

::.:■ :y the binary or relocatable loader. 

adrl<adr.2SP Punch in binary from address adrl to adr2« 

NOTES ; Any $P command that does not contain the < symbol will be interpreted as a 

break proceed command, (see page 12). Hie DEBUG 111 version used with 
the Disk Operating System does not have punch commands. 

EXAMPLES: $H 177777 —high -speed punch in effect. 

40. $F —punch 40 decimal inches blank tape. 

LTT<BRR$P —binary punch from location LTT to BRR. 

LTT$E —punch end block and set binary loader to start at LTT. 

50$F —punch 40 decimal inches blank tape. 

When using the teletype punch, ($H contains 0), the user must stop and 
start the punch to prevent debugging commands from being punched as shown: 

$H 000000 —teletype punch in effect 

$F —punch 10 decimal inches blank tape. User then presses 

ON button on teletype and presses CONTINUE on 
operator panel. 

When punch stops , user presses OFF on teletype punch, presses 
CONTINUE on operator panel. 



. X<X3$P 



X$E 



8.$F 



—punch from . X to X3. User presses OFF on the TTY 
and CONTINUE. 

—punch end block and set start for . X when tape is 
read in. User presses ON on the TTY and CONTINUE, 

When punch stops, user presses OFF on the TTY and 
CONTINUE. 

—punch 8 decimal inches of blank tape. User presses 
ON on the TTY and CONTINUE. 

When punch stops, user presses OFF on the TTY and 

CONTINUE. 
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SEARCH COMMANDS 

FORMAT MEANING 

$S Search from location to location 77777, 

adr$S Search from location to adr, 

adr<$S Search from location adr to 77777. 

adrl<tdr233 Search from location adr l to adr2 . 

NOTES; Current contents of the word and mask registers determine contents 

searched for. See page 1 4. Pressing any teletype key will cause a 
search to abort, 

EXAMPLES : If the current contents of the word register = LDA 1, FIELD and current 
contents of the mask register = -1, then: 

$S —might produce a response; 

FIE LDA 1 FffiLD 
F1E2 LDA 1 FIELD 
FIE3 LDA 1 FIELD 

FIE 3 -DIM$S ««-might produce a response: 

FIE LDA I FIELD 
FJE2 LDA 1 FIELD 

FIE2~2<$3 —might produce a response: 

FIE2 LDA 1 FIELD 
FIE3 LDA 1 FIELD 

FIE2<FIE3+SYN$S —might produce a response: 

FIE2 LDA 1 FffiLD 
FIE3 LDA 1 FIELD 

If the current contents of the word register = FIELD and the contents of 
the mask register = 000377, then: 

^S —might produce a re^pons--: 

FIE LDA 1 FDELD 

FIE 2 LDA 1 FIELD 

FOO ADDZR# 1 SZC —match on right 8 bits 

F-E3 LDA 1 FIELD 
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"TTIXG -SD DELETING BREAKPOINTS 



,he user can set up to eight breakpoints in Ms program, When a breakpoint is encountered 
during execution, the breakpoint causes a transfer to the Debugger before the instruction 
at which it is set is executed. In effect, the setting of the breakpoint causes the program 
instruction to be transferred to the Debugger and a JMP instruction to the Debugger to be 
substituted in the user program. 

Registers 10 to 17 are reserved for the eight debugger breakpoints. Any attempt to place 
other inf ormation in these locations and then execute will wipe out the user program. 
Breakpoint numbers are assigned in reverse numeric order: 7 6 5 . . . 0. 



■?o?,'-:at 

$B 

adr$B 
$D 
n$D 

NOTES: 



$B 




7B TT 


6B TT2 


5B TT3 


TT4SB 


$B 




1 


TT 


6B 


TT2 


CD 


TT3 


43 


TT4 


6$I 


i 


$B 




7B 


rprrt 


5B 


TT3 


.1^ 


TT4 



:- : e.\n;.::g 

Print locations of ail breakpoints. 

Set a breakpoint at location adr. 

Delete all breakpoints. 

Delete ftreakpoint n where n = 7 6 . . . . 

See page 12 to resume execution after a break, 

Breakpoints should not be set at the following types of locations: 

1. Data words or words used as indirect pointers. 

2* Instructions modified during execution. 

3. Instructions that enable and disable interrupts. 

4. Locations where interrupts cannot be delayed for relatively long time, 

5. Locations which test interrupt status. 



-"-command to print out existing breakpoints, 
^-response 

^command to set a new breakpoint. 



••-command to delete breakpoint 6. 
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ENTERING .AND LEAVING THE DF BUGGER VIA BREAKPOINTS 

A user can set a breakpoint at a given instruction in his program, as described on page 9. 
Breaks are not visible to the user unless ttie STOP and EXAMINE switches on the operator's 
panel are set. During program execution a transfer is made to the Debugger when the 
breakpoint is encountered. Hie instruction at which the breakpoint is set is not executed, 
The Debugger prints the breakpoint number, the instruction address, and current status 
of the accumulators, 

When the user has completed debug^ng and wishes to restart execution, he issues a $P or 
n$P command. Execution resumes with the breakpoint instruction. The user, in resuming 
execution, car, set the number of times the instruction at which the break occurred will be 
executed before the debugger is to be reentered. 



FORMAT 



MEANING 



$P 



n$P 



Set break proceed counter to +1 and proceed with execution from current 

break. Command $P is equivalent to 1$P. 

Set break proceed counter to n, where n is the number to times the 

instruction will execute before a transfer to the debugger occurs; proceed 
with execution. 



n$Q 



Open break proceed counter n, where n is 0-7, and print contents. 



EXAMPLE : Suppose a user program contains three breakpoints at symbolic locations 
ATOM1, ATD1G, and ATOM2, A partial listing might be: 



00011 -006201 -ATOM1: 

00012-000052- 

00013-024000- 

00014-106032 

00015-024001- 

00016-107046 

00017-000417 

00020-045407 ATDIG: 

00021-024002- 

00022-045402 

00023-021403 

00024-025404 

00025-006201- 

00026-000621 

00027-000001 



CALL 

CHAR 

LDA 1, C72 

ADCZ#0 ? 1, SZC 

LDA 1, M60 

ADDO0,l,SEZ 

JMP ATOM2 

STA 1, ATOM. 3 

LDA 1, C12 

STA 1, NUMB+1,3 

LDA0,NUM&h2,3 

LDA 1, NUMB+3,3 

CALL 
DMFY 

NUMB 



;AC0 WILL CONTAIN THE 
;INPUT CHARACTER. 



;IS IT A DIGIT? 
;NO 

;SA¥E THE DIGIT. 



;FORM A NUMBER 

;FROM THE STRING OF DIGITS, 

; MULTIPLY PREVIOUS 
;NUMBER BY 10. 



4 2- 



r XT " L\0 i / vT LI A VL\ ' 



DEBUGGER VTA riUZ/ JPOr-IT^ccrf'cL ) 



00035-000754 

00036 -021003 -ATOM2: 

00037-106332 

00040-024004- 



JMP ATOM! 

LDA 1, C133 ;IS Ttffi CHARACTER IN 

ADCZ# 0» 1, SZC ;AC0 A LETTER? 
LDA 131100 



Presume the user is in the Debugger, He prints out Ms breakpoints and his current 
location: 



$B 

7B ATOM1 
6B ATDIG 
5B ATOM2 

. /ATOM+6 JMP ATOM2 

ATDIG-f4$R 

5B ATOM2 

000000 1 000000 2 001461 3 001522 



5$Q 000001 
6$Q 000007 

$P 

5B ATOM2 



^-Debugger prints status information 



«*~break proceed counter 5 is at 1. 

«*-break proceed counter 6 is at 7. 

**~executioii resumed 



000001 1 000000 2 001461 3 001522 

C(AC0) set to 1 by single loop through breakpoint 5. 

100$P —execute 5 looping through breakpoint 

, 100 times. 

5B ATOM2 

000101 1 000000 2 001461 3 001522 

C(AC0) set to 101 by 100 (+1) loops through breakpoint 5. 
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EXAMINING AND SETTWG SPECIAL REGISTERS 



Registers that are used for special purposes and are not accessed in sequential order are: 
j. ecu ' ^ • :.;:'■ v\".- ° t? ••■ - 

Word register which can be loaded with information for searching. 

Mask register which can be used to mask all or part of the word to be searched for. 

Numbers reg ister which determines whether numbers in the special registers will be 
interpreted as decimal or octal. 

Location register which contains a starting location set by the user. 

FORMAT MEANING 

$A Print contents of the four accumulators. 

n$A Open accumulator n (n = to 3). 

$W Open word register and print contents, 

$M Open mask register and print contents, 

$N Open numbers register and print contents, 

$L Open location register and print contents, 

NOTE: Other special registers are' . the interrupt register the Carry and 

TTO-done register, and the TTI-done register, described on page 15. 

EXAMPLES: $N 000000 —numbers register contains all zeroes (octal) 

$A 000100 1 000040 2 000011 3 000017 

Number of the register is printed followed by the contents, given in 
octal, 

2$A 000011 000015 

AC2 is opened, contents altered to 000015, and then closed. 

$N 000000 1 —user puts 1 in numbers register. 

$A +80. 1 +32. 2 +9. 3 +15* 



$N 000000 

$W 000000 NEG 
$M 000000-1 



$s 

$L 000071 

$R 



—numbers register modified to zero. 
—NEG loaded into word register. 

—mask register loaded to permit search 
on NEG with any instruction field format, 

—a search will cause printout of all NEG 

instructions. 
—contents of location register checked 

before resuming execution at that location. 
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EXAMINING AND SETTING SPECIAL REGISTERS (cont'd. ) 
There are three other special registers: 

Interrupt register contains the status of Interrupt Enable, Hie register is set to -1 if 

interrupts are enabled when the Debugger is entered. Otherwise the register is all zeroes* 

Teletype Input register contains the status of teletype input. Bit is set to 1 if teletype 
input is not done. The register contains the character if teletype input is done. 

Carry and Teletype Output register contains the current state of the carry flag and status 
of teletype output. Bit is set to 1 if the carry flag is 1; bit 15 is set to 1 if teletype output 
is done. 



FORMAT 

$1 

$T 

$C 

NOTE; 

EXAMPLES: 
A: 

AMOD: 



B: 



BMOD: 



MEANING 

Open and print contents of interrupt register. 

Open and print contents of teletype input register. 

Open and print contents of carry and teletype output register. 

The DEBUG III version used with the Disk Operating System does not 
have $T and $1 commands. 



USER CODS 

SKPDN TTI 

JMP - -I 
JMP DEBUG 

SKPDN TTI 
JMP-.-l 

DIAC GTTI 
JMP DEBUG 

ADC 

DOAS TTO 
JMP DEBUG 

ADC 
DOAS TTO 
SKPDN TTO 
JMP . -1 

JMP DEBUG 



REGISTER STATUS WHEN DEBUG ENTERED 



$T 000101 



$T 100000 



$C 000000 



$C 000001 
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STARTING AND RESTARTMG A PROGRAM 

Four commands are available for starting and restarting a user program at a location 
other than a breakpoint. 

Two of the commands simply give a starting location. The other two commands provide 
that AC3 will contain the address of the debugger at restart time, so that a return is made 
to the debugger if an instruction points to C(AC3). 



FORMAT 
$R 

sym $R 
$G 
sym $G 

EXAMPLES: 



MEANING 

Restart program at address given in location register, C{$L) 

Restart program at address given by sym.* 

Restart program at C($L); set C(AC3) to address of debugger. 

Restart program at address given by sym; set C(AC3) to address of 
debugger. 



$L 000261 

$R 

7BBQ 
TOP$R 



--contents of location counter checked 
and user program restarted at that point. 

—after a break, user restarts his program 

at a location different from the breakpoint, 
—restart program at TOP. 



USE4$G 



—user restarts program at a different location 
and sets the Debugger location in AC3* 
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The symbol tables of the assembled programs loaded with the Debugger contain the user 
symbols known to the Debugger, These are the local symbols - those known only in a 
single assembled program - and the global symbols known throughout the loaded programs, 



FCaI'.TAT 

$K 

n$R 

s ym $K 
name% 

NOTE: 



EXAMPLES: 



MEANING 

Remove aE symbols (local and global) from input and output. 
Absolute values are used instead* 

Remote all local symbols from output but retain global symbols. 
Absolute values are used Instead of local symbols* n is any 
single digit. 

Remove the user symbol named sym permanently from output. 
The user symbol having a value closest to sym is used instead, 

Restore to output all user symbols previously removed from the 

program named name by n$K commands. 

Symbols are removed from output by the n$K, and sym $K commands 
but may still be used on input. 

Suppose that a program given the title XX by the . TITL pseudo-op 

contains symbols C72 *FD40 and T2. Then: 



505/LDA 1 C72 

C72$K 

505/LDA 1 J?D40f7 

. FD40$K 

. /LDA 1 T2+23 

1$K 

. /LDA 1 +50 

Wo 

505/LDA 1 T2+23 



■—In this examplei, each time a symbol is 

removed, the Debugger substitutes the 
closest symbol with appropriate offset. 

When all local symbols are removed by a 
1$K command? an absolute value is sub- 
stituted. The command XX% restores aH 
symbols not permanently removed from 
output. 
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CONVERSION MODE COMMANDS 

There are five different formats in which information may be printed out, and a symbol is 
associated with each format. Formats of most utility to the user are the instruction, user 
symboL and numeric formats. 



FORMAT 



MEANING 



$= 
$: 

$; 

NOTE: 
EXAMPLES: 



Print last quantity in numeric format. 

Print last quantity in user symbols. Where user symbols exist, 
symbols are used. 

Print last quantity In Instruction format. 

Print last quantity in half-word format. 

Print last quantity ASCII characters. {Tbe symbol is an apostrophe 
or an accent acute, ) 

Print information following in numeric format. 

Print information following in user symbol format. 

Print information following in instruction format. 

Print information following in half-word format. 

Print information following in ASCII format. 

The default format for instructions is instruction format; the default 
format for accumulator and other special register contents is numeric. 



IN1T/JMP ABC :BUFF+3 =000777 ;JMP ABC - 1 370 f <r><370> 

The instruction at location INIT is printed out in default instruction format. 
Then in each subsequent conversion, the quantity printed last is converted to 
the requested format. 



ATi/JSR § . SAVE 

$: 

* /CALL J 
AT1+ CHAR J" 
ATI+2 24050 J 

. /17551 000252 £ 

17552 017550 ^z 

17553 016635^7" 

17554 006331^ J 



sprint instruction at location ATI (default instruction 

format) 
-•-change to user symbol format 
«*-print current location 

and next two locations in user 

symbol format 
**~change to numeric format 
«*-priat current location and next three locations in 

numeric format 
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ERROR RESPONSES 

The debugger uses the following two error responses: 

SYMBOL MEANING EXAMPLES 



U 



Unidentified symbol 1400+SST/U 



Do not understand; 
command attempt 
aborted. 



(where SSTis not found) 

. /LDA 1 FDF LDA 1 FPU 

(attempt to substitute 
unidentified symbol FF for 
user symbol FDF, ) 

ADD§? 
-1$R? 

(in each case the command 
is improperly terminated, 
contains a given symbol in 
an illegal position* etc. ) 

AB$B? 

(an attempt to set a 
breakpoint at location AB 

when there are already 8 
breakpoints set.) 
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APPENDIX 
LOADING AND USE OF SYMBOLIC AND ABSOLUTE VERSIONS OF DEBUG ill 

l - Relocatable _ Debugger - No Disk Operati ng System 

a, Loading 

Load the Bootstrap loader as described in document 093-000002-01 

Laid the Unary loader as described in document 093 -000003 -00 

Load the Relocatable Loader as described in document 093-000039-00. 
Following are the loader signals and standard user responses to lead 
DEBUG III and the user program. User responses are underscored. 



SAFE = ^ 



*4S 



*2 



*6 



^-carriage return gives a standard save of 
200 locations 

<-DEBUG III should be in high speed tape reader 
for loading when this command is given. 

^-command to load all symbols. Loader sets 
pointer in location 44 and signals " S" . 

*-User program should be in high speed tape 

reader ready for loading when this command 
is given. The user program must have at 
least one symbol. 

—command to print a loader map is usually 
given. 



NMAX 005640 

ZMAX 000255 
DEBUG 000400 

*8 ^Terminate loading 

User sets the data switches on console panel to 400s and presses START. 

User is now in the debugger and can issue a name % command. 



-20- 



Storage is allocated as shown below. 



During Loading 



After Termination of Leading 



grows down 



grows up 



SAFE 



SYMBOL 
TABLE 



AVAILABLE 
SPACE 



^top of memory * 



LOADED 
USER 
ROUTINES 



LOADER 




^-pseudo 
location 
00000 




SAFE 



SYMBOL 
TABLE 



AVAILABLE 

SPACE 



LOADED 
USER 

ROUTINES 



b. Use 

All commands described in this manual apply to the Relocatable Debugger without 
Disk Operating System. 8K core configurations are recommended; it is usually not 
possible to load the symbol table when using a 4K configuration. 
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2, Absolute Debugger - 4K and 8K core configurations 

a. Loading 

1, Key in the Bootstrap loader origin 



07757 = 4K configuration 

17757 = 8K configuration 

::, 1—x:; co:x cyx-f.-r-:.::?.^.^ ir 0?.f). swishes 

07770 = 4K 

17770 = 8K 

3. Mount Binary loader tape in input device and set BIT data switch for 

input device 

1 = high speed tape reader 

= teletype reader 

4. Press RESET. Press START, 

5. Mount DEBUG III tape in input device and set data switches as follows: 
BIT data switch indicates input: 

= teletype reader 

1 = high speed tape reader 

Remaining dam switches indicate core configuration: 

07777 = 4K configuration 

17777 = 8K configuration 

6 Press START. 

7, Mount user program tape in input device and press START. 

b, Use 

Input to and output from absolute versions of DEBUG III include all instruction 

mnemonics and symbols (§> #, etc. ) used in assembly language. No pointer is 
set by the binary loader to a symbol table, however, and symbols cannot be 
interpreted. 
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Examination of a scries of memory locations might result in the following printout; 

1712/ 

1712 STA 2 2107^f 

1713 LDA 1654 <£ 

1714 MOV OOSZE^ 

1715 JSR 1677 + 

1716 LDA 1651"^ 

The command: name% 

is meaningless in absolute debugger mode. Otherwise, all commands described in 
this manual are available for debugging if absolute locations are substituted for user 
symbols. 

Hie commands: 

: and $: 
which normally cause a change to symbolic printout will be interpreted by the debugger 
to mean: 

= and $ = 
or a change to numeric format, 

3. Relocatable Debugger - Disk Operating System 

Information on loading the relocatable debugger used with the operating system 
will be available at a later date. Since the operating system handles many of the 
functions described in this manual, the following commands will be unnecessary: 

sym $Q 

adr ( y disk commands 

adr ) 



$F 
nSF 

$E 

adr $E 

adr i <adr 2$? 



punch commands 



$1 \ interrupt and Til register commands 

$T J 
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